home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / perform / netframe / readme.dx < prev    next >
Text File  |  1996-07-10  |  10KB  |  200 lines
  1.                          NetFRAME Systems Inc.
  2.  
  3.  
  4.  
  5.                                   DX
  6.                  A Disk Exerciser for NetWare 386 (TM)
  7.  
  8.  
  9. WHAT IS DX?
  10.  
  11. DX (Disk eXerciser) is a portable performance analysis tool.  It can be run
  12. on systems that run Novell's NetWare 386 (TM).  DX was developed at
  13. NetFRAME Systems Inc., in response to a need to analyze and characterize
  14. physical disk IO performance, without file system caching effects,
  15. over a variety of operating conditions.
  16.      DX is a NetWare Loadable Module, or NLM.  It can be loaded and run from
  17. the operator's console of a NetWare 386 system.  It can provide a variety
  18. of system configuration options in examining physical disk IO throughput.
  19. It is portable and easy to use, providing users a variety of reproducible
  20. conditions.
  21.  
  22. BEFORE YOU START
  23.  
  24. DX is provided on either a 3.5" or 5.25" floppy, along with this file.  Its 
  25. filename is DX.NLM.  You must have a system capable of running NetWare 386,
  26. a copy of NetWare 386, Rev 3.0 or higher, and at least one hard disk.
  27.      DX should not be run on any disk that has volume SYS mounted.
  28. This is because DX can do destructive writes on any location in a NetWare 
  29. partition.  In general, if you wish to run DX on a system with useful data 
  30. on the disks, you must backup all of the data before running DX, and later 
  31. restore the data.
  32.      DX can only be run on disks or drives that have a NetWare partition on 
  33. them.  If you wish to run DX on a disk that doesn't have a NetWare partition,
  34. you must create one using the INSTALL utility provided with NetWare.  See
  35. the appropriate Novell documentation to use this utility.
  36.  
  37. HOW TO RUN DX
  38.  
  39. First, bring up NetWare 386 on your system.  Do not mount SYS or any other
  40. volume(s).  Be sure to load the appropriate disk driver(s) to exercise your
  41. disks.  Other NLMs could be loaded (e.g. INSTALL, MONITOR) as required, but
  42. they are not necessary to run DX. Be sure all useful data on your drives
  43. are backed up.  Either download the dx.nlm into your DOS partition, copy 
  44. into the system directory of the Netware 386 volume, or load from a floppy 
  45. drive.  At the operator's console, type LOAD DX.  DX will clear the screen 
  46. and ask a series of questions:
  47.  
  48. 1.  Exerciser Access Pattern [S=Sequential R=Random]? S
  49.  
  50.     The answer to this question determines how DX will access the disk-
  51. sequentially or at random.  In sequential access, DX will start requesting 
  52. data at the beginning of the drive, and increment the block address for
  53. each successive operation.  When it reaches the end of the drive, it will
  54. wrap around and start at 0 again.  In random access, a random number
  55. generator with a uniform distribution is used to generate a block address 
  56. ranging from the beginning to the end of the drive.
  57.      Sequential access tests measure a system's capacity to read or write
  58. large files. Random access tests, with uniform distribution, are useful in 
  59. examining a system's ability to handle heavy IO demands with poor disk locality.
  60.  
  61. 2.  Exerciser test type [R=Read W=Write]? R
  62.  
  63. The answer to this question determines if DX will perform all reads or all
  64. writes for the duration of the test.  Note that data
  65. read from drives by DX is discarded.  Data written to drives is not 
  66. subsequently verified by this program.  Use of the NetWare parameter "Enable
  67. Disk Read After Write Verify" can be used to provide write verify performance
  68. measurement, in concert with DX's write option.  However, not all disk
  69. drivers implement this feature, even though the option is turned on.  Use care
  70. in examining the results before assuming the feature is supported.  There
  71. should be a noticeable drop in write throughput when write verify is on and
  72. supported. The default operation is Read.
  73.  
  74. 3.  Number of kilo bytes <KB> per IO [1-60]? 8
  75.  
  76. This answer instructs DX on how big each physical IO should be--1 to 60KB
  77. long.  The default is 8KB per IO.  Small IO operations (1KB) can give an
  78. indication of the maximum IOs per seconds a controller/drive(s) combination
  79. can sustain.  Medium size IOs can give an indication of how a common NetWare
  80. system may perform (many NetWare systems are configured with 4-16KB 
  81. cache buffer sizes, which corresponds to the blocksize of the  
  82. disk request).  Large IOs can give an indication of the data throughput that 
  83. is sustainable, since large IOs usually minimize controller to drive protocol
  84. overheads.
  85.  
  86. 4.  Number of concurrent IO to queue per drive [1-64]? 3
  87.  
  88. DX is able to build and maintain a queue of requests for each drive before
  89. calling the disk driver to act on those requests.  This number lets DX know 
  90. how deep to keep this queue.  This feature is useful for intelligent
  91. drivers and/or controllers that are capable of issuing multiple IOs,
  92. for elevator algorithms that take advantage of sorts to improve disk access
  93. time, etc.  The default queue depth is 3.
  94.  
  95. 5.  Screen Update Interval in seconds [1-60]? 5
  96.  
  97. This tells DX how often to calculate and display statistics on the console.
  98. The default is 5 seconds.
  99.  
  100. 6.  Exercise Generic Drive  1-0-0? y
  101.  
  102. For each drive in the system with a NetWare partition, DX will ask if you want
  103. to include that drive in the test.  This is useful for excluding certain
  104. drives with data you want untouched, or to characterize your system on a disk 
  105. by disk, controller by controller, or system wide basis.  The default answer
  106. to these questions is yes, so care is required.  The format of the drive 
  107. number is Controller number, Device ID, LUN.  Also note that the search for
  108. disk drives will end when DX encounters a drive without a NetWare partition.
  109.  
  110. THE DX DISPLAY
  111.  
  112. After questioning you about all the drives with NetWare partitions, DX will
  113. clear the screen and start exercising the disk(s) you specified in the manner
  114. you requested.  After the screen update interval, it will display the statistics
  115. it has gathered so far.  Here is a sample display:
  116.  
  117. --------------------------------------------------------------------------------
  118. NetFRAME Disk Test: Sequential Read 32KB/IO with 3 IOs queued    Page 1 of 1
  119.       Disk                KB/sec.   IOs/sec  Ave. KB/s  Total IOs   Errors
  120. Generic Drive  1-0-0        812         25      752       9976         0
  121.  
  122. Aggregate Disk Performance  812         25      752       9976         0
  123. Server Utilization            7%
  124. Q to quit or page number to view
  125.  
  126.  
  127. --------------------------------------------------------------------------------
  128. NOTE:  The numbers supplied above are provided for reference only and do not
  129. reflect the physical disk performance of any system.
  130.  
  131. The top line identifies DX, the type of test it is running, and the page 
  132. being displayed.  DX can display statistics on very large systems.  It has been
  133. tested on a system with 32 drives.  Each page of a DX display has statistics
  134. for up to 16 drives.  Aggregate statistics are shown on every page.
  135.      To display the information on any page, type in the page number on the
  136. keyboard at the operator's console.  After the next display interval, that page
  137. will be shown until a new page number is typed, or you exit DX.
  138.      To exit DX, type "q" (the letter only).  DX will ask you if you really want
  139. to exit.  Type y or n at the prompt, which will appear at the bottom line of
  140. the display.  The default is yes.
  141.      You may also do other things while DX is running.  You may use the 
  142. <ALT-EXC> or <CTL-ESC> key combinations to cycle through any other NLMs you
  143. have running, or to the console. However, other activities on the system
  144. could perturb your results.
  145.      The second line consists of column heading, to identify which statistics
  146. are collected in that column.  The Disk column identifies which drive is
  147. being tested.  The KB/sec column identifies how many kilobytes per second were
  148. transferred during the last display interval.  The IOs/sec column shows how
  149. many physical IOs per second were completed during the last display interval.
  150. The AVE. KB/s column displays the average data transfer rate since the beginning
  151. of the test.  The Total IOs column shows the number of completed physical IOs
  152. since the beginning of the test.  The Errors column details the reported
  153. physical IO errors since the beginning of the test.
  154.      DX then displays statistics for up to 16 drives per page.  It also 
  155. sums the statistics for all tested drives on the AGGREGATE Disk Performance
  156. line.  These statistics are shown on all pages.  Finally, the CPU utilization
  157. for the server is displayed.  CPU utilization is the percentage of processor 
  158. time used marginally to process the benchmark results and mostly to execute 
  159. the disk IO requests.  The remainder (unused CPU cycles) is the processor time
  160. available to perform other functions on the system.
  161.  
  162.  
  163. CAVEATS
  164.  
  165. To change test parameters, you must quit the program and reload it.
  166.  
  167. There is no explicit way to capture DX displays to a file or files.
  168.  
  169. DX only displays information about completed IOs.
  170.  
  171. DX has no provision for gathering statistics on a per controller basis.
  172.  
  173. DX has no provision for doing 512 byte (a common disk sector size) IOs.
  174.  
  175. DX has no provision for operating only on part of a NetWare partition.
  176.  
  177. DX tests can be destructive to data.
  178.  
  179. DX is not a capacity planning tool and does not predict total system demands
  180. for particular customer environments.
  181.  
  182. When running both DX and NX, be sure to load both NLMs before starting
  183. either.  If you don't, server CPU utilization percentages will be
  184. in error.  This is due to the way NetWare 386 handles the loading of NLMs
  185. in relation to server CPU utilization.
  186.  
  187. DX is provided as is, with no warranty, explicit or implied.  NetFRAME Systems
  188. Inc. assumes no responsibility for any information provided by DX, nor any
  189. effects, direct or indirect, on your system.  DX has been tested on NetFRAME
  190. systems, and on a limited number of ISA, EISA, and MCA systems, and has shown 
  191. no deleterious side effects to systems under test.  However, DX may exhibit 
  192. side effects on your system.
  193.  
  194. TRADEMARKS
  195.  
  196. Novell, NetWare, NetWare 386, NetFRAME, and NetFRAME Systems, are the trademarks
  197. of Novell, Inc. and NetFRAME Systems Inc.
  198.  
  199. (c) 1990 NetFRAME Systems Inc., 1545 Barbar Lane, Milpitas, CA  95035
  200.